home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / extensions / man / glgethistogramext.z / glgethistogramext
Encoding:
Text File  |  1996-11-11  |  6.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee          ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT - get histogram table
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  14.                              GLboolean _r_e_s_e_t,
  15.                              GLenum _f_o_r_m_a_t,
  16.                              GLenum _t_y_p_e,
  17.                              GLvoid *_v_a_l_u_e_s )
  18.  
  19.  
  20. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  21.      _t_a_r_g_e_t  Must be GGGGLLLL____HHHHIIIISSSSTTTTOOOOGGGGRRRRAAAAMMMM____EEEEXXXXTTTT.
  22.  
  23.      _r_e_s_e_t   If GGGGLLLL____TTTTRRRRUUUUEEEE, each component counter that is actually returned is
  24.              reset to zero.  (Other counters are unaffected.)  If GGGGLLLL____FFFFAAAALLLLSSSSEEEE,
  25.              none of the counters in the histogram table is modified.
  26.  
  27.      _f_o_r_m_a_t  The format of values to be returned in _v_a_l_u_e_s.  Must be one of
  28.              GGGGLLLL____RRRREEEEDDDD, GGGGLLLL____GGGGRRRREEEEEEEENNNN, GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRRGGGGBBBBAAAA,
  29.              GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, or GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.
  30.  
  31.      _t_y_p_e    The type of values to be returned in _v_a_l_u_e_s.  Must be one of
  32.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____SSSSHHHHOOOORRRRTTTT,
  33.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT, GGGGLLLL____IIIINNNNTTTT, or GGGGLLLL____FFFFLLLLOOOOAAAATTTT.
  34.  
  35.      _v_a_l_u_e_s  A pointer to storage for the returned histogram table.
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT returns the current histogram table as a one-
  39.      dimensional image with the same width as the histogram.  No pixel
  40.      transfer operations are performed on this image, but pixel storage modes
  41.      that are applicable to 1D images are honored.
  42.  
  43.      Color components that are requested in the specified _f_o_r_m_a_t, but which
  44.      are not included in the internal format of the histogram, are returned as
  45.      zero.  The assignments of internal color components to the components
  46.      requested by _f_o_r_m_a_t are:
  47.  
  48.                        Internal Component   Result Component
  49.                        _____________________________________
  50.                        red                  red
  51.                        green                green
  52.                        blue                 blue
  53.                        alpha                alpha
  54.                        luminance            red
  55.  
  56. EEEERRRRRRRROOOORRRRSSSS
  57.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____HHHHIIIISSSSTTTTOOOOGGGGRRRRAAAAMMMM____EEEEXXXXTTTT.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee          ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not one of the allowable
  75.      values.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not one of the allowable values.
  78.  
  79.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT is executed
  80.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  81.      ggggllllEEEEnnnndddd.
  82.  
  83.  
  84. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  85.      Histogramming and minmax are supported only on RealityEngine,
  86.      RealityEngine2, and VTX systems.  However, on these systems histogram and
  87.      minmax may not be used when rendering to pixmaps.
  88.  
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      ggggllllHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT, ggggllllRRRReeeesssseeeettttHHHHiiiissssttttooooggggrrrraaaammmmEEEEXXXXTTTT, ggggllllGGGGeeeettttHHHHiiiissssttttooooggggrrrraaaammmmPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.